home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / mac / VIEWERS / AMIGA / viewtek3.lha / VT / VT.doc < prev    next >
Text File  |  1993-01-11  |  10KB  |  267 lines
  1.              Viewtek 1.03b - Another Picture/Animation Viewer
  2.  
  3.                         Written by Thomas Krehbiel
  4.                               January 1993
  5.  
  6.  
  7.  
  8.  
  9. INTRODUCTION
  10. ~~~~~~~~~~~~
  11.    Some of you may remember an ILBM/ANIM viewer program I wrote a while
  12. back called "TIV".  Some would say that "Viewtek" is TIV 2.0, but I
  13. consider it a totally different and much improved program (no part of TIV
  14. is in Viewtek; it is all rewritten from scratch).  (If you're using TIV
  15. now under 2.0 I *strongly* suggest you dump it in favor of Viewtek.)
  16.  
  17.    Viewtek was written with a few objectives in mind.  I wanted a program
  18. that first and foremost was totally 2.0 (and 3.0) compatible.  I wanted it
  19. to take advantage of 3.0 and the AGA chips wherever possible.  I wanted it
  20. to show ANIMs as good or better than TIV did, with support for any and all
  21. display modes.  I also wanted to be able to render decent (if not
  22. spectacular) representations of 24-bit ILBMs, GIFs, and JPEGs.  And I
  23. wanted to keep the program internally modular enough to support 3rd party
  24. display devices fairly easily.
  25.  
  26.    The result you have before you.
  27.  
  28.  
  29. FEATURES
  30. ~~~~~~~~
  31.    o Requires Workbench 2.04 or greater.
  32.    o Shows most ILBM's (including 24-bit ILBM's).
  33.    o Shows most Compuserve GIF format images.
  34.    o Shows most JFIF format JPEG images.
  35.    o Shows most ANIM Op-5 format animations, with support for
  36.      different palettes for each frame.
  37.    o Supports SHAM, CTBL, and PCHG images.
  38.    o Full support of ECS/AGA display modes (ie. show 256 color GIF's
  39.      directly, show 800x600xHAM animations, etc.).
  40.    o Supports viewing contents of clipboard.
  41.    o Iconifies to a Workbench AppIcon.
  42.    o Includes a version written for GVP's Impact Vision 24, to support
  43.      true 24-bit display.
  44.    o And even includes a stripped-down version that doesn't show GIF's
  45.      or JPEG's for those who don't need it.
  46.  
  47.  
  48. DISTRIBUTION
  49. ~~~~~~~~~~~~
  50.    Viewtek is being distributed as Freeware.  It may be freely distributed
  51. to any bulletin board service, network, or public domain collection, so
  52. long as no fees (beyond reasonable media fees) are charged for such
  53. distribution.  I'm not asking for donations on this one, but feel free to
  54. drop me a note (preferably e-mail) or something if you want.
  55.  
  56.    Note, however, that Viewtek is NOT public domain.  The author retains
  57. all rights to the program.
  58.  
  59.  
  60. OOPS!
  61. ~~~~~
  62.    Previous versions of the Viewtek documentation left out a very
  63. important statement:
  64.  
  65.    This software is based in part on the work of the Independant JPEG
  66. Group.
  67.  
  68.    I'd just like to apologize to the Independant JPEG Group for not having
  69. included this, they deserve full credit for their work in bringing this
  70. popular compression format to the computer world at large.
  71.  
  72.  
  73. INSTALLATION
  74. ~~~~~~~~~~~~
  75.    Viewtek requires no special libraries or fonts or anything to run.
  76. Simply drag the Viewtek icon to wherever you wish to install it.  It may
  77. be run from a Shell, Workbench, or even your favorite dirutil.
  78.  
  79.    The IV-24 version of Viewtek, however, requires that you have a copy of
  80. GVP's "fye.library" in your LIBS: directory.  (If you have an IV-24,
  81. chances are pretty good you have this installed already.)
  82.  
  83.  
  84.  
  85. DISABILITIES
  86. ~~~~~~~~~~~~
  87.    Okay, what *doesn't* it do?
  88.  
  89.    - No color cycling (yet?).  Why?  I have exactly one picture that
  90.      color cycles out of hundreds of images and I never look at it
  91.      anyway, so it wasn't a high priority.
  92.  
  93.    - Some CTBL images may not quite show properly, more than likely
  94.      due to more palette changes per line than can be shown properly
  95.      with the copper.  Same may be true for SHAM pictures.  I probably
  96.      will not fix this because I don't really see much value in these
  97.      types of pictures anyway.  It may help to force the images
  98.      to be shown in NTSC/PAL on an A4000, or move the picture
  99.      to the right (with control arrow keys).
  100.  
  101.  
  102.  
  103. USEAGE FROM SHELL
  104. ~~~~~~~~~~~~~~~~~
  105.    Files/M        One or more files/directories/patterns.  Standard
  106.                   AmigaDOS wildcards are supported.
  107.  
  108.    Delay/N        Time in seconds to show each file before moving on.
  109.                   Default is to wait for user to click a button.
  110.  
  111.    LowMem/S       Do not double-buffer pictures, saves some chip memory.
  112.  
  113.    Repeat/N       Number of times to repeat showing the pictures.
  114.  
  115.    Hide/S         Hide the process of reading the pictures; by default you
  116.                   can watch as VT scans in the image.  Note that for large
  117.                   GIF's and IFF24's, scanning in the image can take a
  118.                   while, so hiding the process can cause some confusion.
  119.                   Also note that when viewing on the IV24, hide is
  120.                   automatically enabled (due to the nature of the IV24).
  121.  
  122.    All/S          Recursively enter subdirectories to show pictures.
  123.  
  124.    Iconify/S      Launch VT in iconified mode (handy for putting VT in
  125.                   your WBStartup drawer).
  126.  
  127.    Forever/S      Repeat showing the pictures forever and ever and ever.
  128.  
  129.    Clip/S         Show contents of clipboard instead of a file.
  130.  
  131.    Unit/N         Select clipboard unit number, default is 0.
  132.  
  133.    Loop/N         Number of times to loop animation before proceeding,
  134.                   default is to loop forever.
  135.  
  136.    Speed/N        Animation playback speed, in jiffies/frame.
  137.  
  138.    Cont/S         Force animations to be considered "continuous", that is,
  139.                   the animations are assumed to have 2 looping frames
  140.                   built onto the end.  Normally, VT will only play an
  141.                   animation in continuous mode if a DPAN chunk is found
  142.                   (DPaint animations are always continuous).  There is no
  143.                   other way that I know of to tell if an animation is
  144.                   continuous or not.
  145.  
  146.    Hires/S        Force an image or animation into hires.
  147.  
  148.    Lace/S         Force an image or animation into interlace.
  149.  
  150.    NoBusy/S       Normally, VT displays a busy pointer as it reads in
  151.                   images.  This option disables that busy pointer.
  152.  
  153.    Default/S      Force images to use Default monitor (useful for forcing
  154.                   NTSC stuff to promote to scan-doubled on an AGA machine).
  155.  
  156.    NTSC/S         Force images to use NTSC monitor.
  157.  
  158.    PAL/S          Force images to use PAL monitor.
  159.  
  160.    ILBM/S         Force VT to look for FORM ILBM's, regardless of
  161.                   what the file actually is.
  162.  
  163.    NoScroll/S     Force VT not to make picture screens autoscroll.
  164.                   For some reason, making a Super72 or SuperHires screen
  165.                   autoscroll shifts it way over to the left (at least on
  166.                   my machine), so here is the somewhat kludgy solution
  167.                   until I figure out what gives here.
  168.  
  169.    Save/K         After looking at Steve Hines' "QuickGrab" program (an
  170.                   excellent utility, BTW), I realized that it could be
  171.                   useful to save the resulting images that VT renders of
  172.                   GIF's and JPEG's for posterity.  So, this option
  173.                   (which must be followed by a filename) will save the
  174.                   screen that VT produces to a standard ILBM file.  Just
  175.                   keep in mind that the images VT renders aren't nearly
  176.                   as good as they could be.
  177.  
  178.  
  179. USEAGE FROM WORKBENCH
  180. ~~~~~~~~~~~~~~~~~~~~~
  181.    All of the options above may be used (except Files/M) as a tool type.
  182. The following additional tool type may be set:
  183.  
  184.    DEFAULTDIR     Choose default directory where file requester opens.
  185.  
  186.  
  187.  
  188. VIEWING COMMANDS
  189. ~~~~~~~~~~~~~~~~
  190.    ESCAPE         Abort viewing immediately.
  191.  
  192.    BACKSPACE      Abort viewing current directory (when using 'ALL').
  193.  
  194.    LMB/RMB        Go to next picture.
  195.  
  196.    CTRL+Arrows    Move image/anim around on the display (overscan position).
  197.  
  198.    Up Arrow       (Anim Only) Return to beginning of the animation.
  199.  
  200.    Right Arrow    (Anim Only) Pause/single step animation.
  201.  
  202.    Down Arrow     (Anim Only) Resume playing animation after paused.
  203.  
  204.    C              (Anim Only) Toggle "continuous" mode.
  205.  
  206.  
  207. THE AUTHOR
  208. ~~~~~~~~~~
  209.    I can be reached on BIX as "tkrehbiel" if you want to email me about
  210. something (like, say, bugs).
  211.  
  212.    You can also reach me on the Late Nite BBS (804-262-9944) as Tom Krehbiel
  213. (user #13).
  214.  
  215.    As a last resort my U.S. Mail address is:
  216.  
  217.       Thomas Krehbiel
  218.       10747 Surry Road
  219.       Chester, VA  23831
  220.  
  221.    (Don't expect quick mail response.)
  222.  
  223.  
  224. SHAMELESS PLUG
  225. ~~~~~~~~~~~~~~
  226.    Buy ImageFX.  You won't regret it.  Honest.  :)
  227.  
  228.  
  229.  
  230. REVISION HISTORY
  231. ~~~~~~~~~~~~~~~~
  232. 1.03b                Now allows showing directories via. file requester.
  233.                      Shows >= 800x600 GIF's in Super72 mode if available.
  234.                      More robust error messages on display open fail.
  235.                      Now uses BestModeID to show undisplayable modes.
  236.                      Doesn't close screen on first click of LMB after inactivity.
  237.  
  238. 1.03a    12/15/92    Fixed unbelievably stupid bug in AppIcon stuff.
  239.  
  240.  
  241. 1.03     12/10/92    Fixed hanging locks when used as AppIcon.
  242.                      Added LORES,NOLACE,ILBM options.
  243.                      Always sets autoscroll now, and still centers 'em.
  244.                      Added NOSCROLL option to disable autoscroll.
  245.                      Added SAVE option to save rendered pictures.
  246.                      Handles animation playback a bit better.
  247.  
  248. 1.02a    11/25/92    More accurate overscan calculation.  (Maybe not)
  249.  
  250. 1.02     11/24/92    Stock version renders to HAM8 mode if available.
  251.                      Oops, fixed so you can select just one file from ASL freq.
  252.                      Fixed problem with VT's abort "sticking".
  253.                      Fixed problems with centering AGA animations.
  254.                      Added NTSC/PAL/DEFAULT options.
  255.                      Now examines DPAN chunks for frame rates.
  256.                      Fixed problems with 'odd' sized anims on AGA.
  257.                      Defers allocating ASL struct until needed.
  258.                      More generalized copper stuff.
  259.  
  260. 1.01     11/10/92    Now more intelligent about picking JPEG viewmodes.
  261.                      Handles ANIMs with masking planes.
  262.                      Now able to respect ANIM's reltime by pressing F10.
  263.                      Added busy pointer while loading images.
  264.  
  265. 1.00     11/4/92     Initial version.
  266.  
  267.